Reading from a Stream

You can retrieve information about an open stream by using the AVIStreamInfo0RZH38 function. This function fills the AVISTREAMINFOEW_M7X structure with information such as the type of data in the stream, the compression method used when writing stream data, the suggested buffer size, the playback rate, and a text description of the stream.

Some members of the AVISTREAMINFO structure are also present in the AVIFILEINFO0DY60 structure. The information in the AVIFILEINFO structure applies to the entire file. The information in the AVISTREAMINFO structure is specific to the accessed stream and has precedence over the information in the AVIFILEINFO structure.

If a stream has supplementary information associated with it, you can retrieve this information by using the AVIStreamReadDataJMC6YL function. This function returns the information in an application-supplied buffer. Supplementary stream information might include configuration settings for the compression and decompression methods used on a stream. You can obtain the required buffer size by using the AVIStreamDataSizeBV9VA. macro.

You can retrieve formatting information about a stream by using the AVIStreamReadFormat1.CGTD5 function. This function returns a stream-specific structure in an application-supplied buffer. For a video stream, the buffer contains formatting information in a BITMAPINFO.2PXNH structure. For an audio stream, the buffer contains formatting information in a WAVEFORMATEX2R_J_MS or PCMWAVEFORMAT329HC5C structure. For other stream types, the stream handler returns information specific to the stream. You can determine the required buffer size by using AVIStreamReadFormat and specifying a NULL buffer address or by using the AVIStreamFormatSize1.AQ75 macro.

You can retrieve the multimedia content in a stream by using the AVIStreamRead2.D1_I2 function. This function copies raw data from the stream into an application-supplied buffer. For video streams, this function retrieves the bitmapped images that make up the frame content. For audio streams, this function retrieves waveform-audio samples that make up the sound content. You can determine the required buffer size by using AVIStreamRead and specifying a NULL buffer address or by using the AVIStreamSampleSizeD22MAH macro.

Some AVI stream handlers introduce delays associated with software and hardware initialization or coordination. You can inform these handlers to prepare for data streaming by using the AVIStreamBeginStreaming5F14OA function. This function lets the stream handler allocate and initialize the resources it needs. To inform these handlers when streaming has ended, use the AVIStreamEndStreaming11C16KW function. This function lets the stream handler deallocate the resources it allocated for AVIStreamBeginStreaming.

The AVIStreamRead function does not provide decompression services. For information about compressing and decompressing audio streams, see Audio Compression ManagerCCME5E. For information about compressing and decompressing video streams, see Video Compression Manager87.6PP. For information about compressing and decompressing individual frames in a video stream, see Working with Compressed Video Data in a Stream1FSP0KJ.